Skip to content

feat: add TypeDoc API reference deployed to GitHub Pages#114

Merged
zeevdr merged 1 commit into
mainfrom
feat/typedoc-pages
Jun 3, 2026
Merged

feat: add TypeDoc API reference deployed to GitHub Pages#114
zeevdr merged 1 commit into
mainfrom
feat/typedoc-pages

Conversation

@zeevdr
Copy link
Copy Markdown
Member

@zeevdr zeevdr commented Jun 3, 2026

Summary

  • Establishes TypeDoc as the API documentation tool so all exported symbols have machine-generated, browsable API reference rather than hand-maintained prose
  • Deploys the reference to GitHub Pages automatically on every push to main and on version tags, giving users a stable, versioned URL to bookmark
  • Ensures TSDoc coverage baseline by adding missing doc-comments to all exported symbols (PROTO_VERSION, retry code constants)

Test plan

  • npm run docs runs locally and generates api-docs/ without errors
  • npm run build still passes (no type regressions)
  • npx biome check --write src/ reports no issues
  • api-docs/ is gitignored — generated output not committed
  • GitHub Pages enabled on the repo (build_type=workflow)
  • Workflow triggers on push to main and on v*.*.* tags, plus workflow_dispatch

Closes #10

Adds TypeDoc configuration and a GitHub Actions workflow that builds and
deploys the API reference to https://opendecree.github.io/decree-typescript
on every push to main and on version tags. The generated output goes to
api-docs/ (gitignored) to avoid conflicting with the existing docs/ markdown
files. All exported symbols now have TSDoc comments. GitHub Pages has been
enabled on the repo via the API.

Closes #10

Co-Authored-By: Claude <noreply@anthropic.com>
@zeevdr zeevdr added size: M Moderate — a day or two, clear scope priority: P2 Nice-to-have labels Jun 3, 2026
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Jun 3, 2026

Bundle size

Entry Size Budget Status
dist/index.js 101.4 kB 160000

@codecov
Copy link
Copy Markdown

codecov Bot commented Jun 3, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@zeevdr zeevdr merged commit d7aac43 into main Jun 3, 2026
17 checks passed
@zeevdr zeevdr deleted the feat/typedoc-pages branch June 3, 2026 10:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

priority: P2 Nice-to-have size: M Moderate — a day or two, clear scope

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Publish TypeDoc API reference to GitHub Pages

1 participant